Runing mbarivision
mbarivision is invoked from command line and has many many command line options. A list of the available command options can be found here.
Examples
In mbarivision/samples a movie file composed of several frame is provided. The command line examples are executed from the mbarivision directory.
| Goal | Command | Outputs | Comments |
|---|---|---|---|
| Detect events and outline the events in the output frames |
mbarivision --in=raster:samples/f#.ppm --out=display --input-frames=0-99@1 --mbari-save-output | frames with events outlined in bounding box |
For a full list of options in the runscript script, simply run the script with no arguments.There are several options here. The --in option says to take input from the named raster file; several raster file formats are supported, including png and pnm (ppm/pgm/pbm). ]. When you pass the filename to --in, put a '#' in the place where the frame number should go. Thus, it will read f000000.ppm, f000001.ppm. It is important to format the filenames with a single dot '.' e.g. a filename formatted like T.f00000.ppm isn't supported, but Tf00000.ppm is okay, in this case you would pass the in argument with Tf#.ppm. By default, it will keep reading input files until it encounters a missing raster file. If you want it to stop sooner, you can specify a frame range with the --input-frames option, such as --input-frames=0-99@1. Same than the previous example, but this time the output will be a sequence of 100 frames with the events detected outlined by a bounding box. |
| Detect events, but change the tracking mode, cache size, and min/max event areas, and save the result into an XML file. |
mbarivision --in=raster:samples/f#.ppm --out=display --input-frames=0-99@1 --mbari-cache-size=15 --mbari-tracking-mode=BoundingBox --mbari-min-event-area=100 --mbari-max-event-area=10000 --mbari-save-events-xml=./benthic.xml |
XML file |
Similar to above, except here we change the default tracking mode, and only keep objects with area between 100-1000 square pixels. Also the results are saved to an XML file in the samples folder as benthic.xml. |
Running mbarivision with runclip
The main script for processing a clip with the mbarivision executable is the bash script runclip . runclip will uncompress the video into individual frames and setup the command-line arguments for running mbarivision. For a full list of the runclip options, simply run runclip with no arguments.
runclip
 | Useful Information runclip will not work for all video formats. It uses the transcode software. Therefore, only video that transcode can decode will work with runclip. The steps for installing transcode are described here |
To use this script, first setup the PATH variable to include the directory runclip is installed in. If you have installed the scripts in, for example, your home directory in the directory aved/scripts
export PATH=~/aved/scripts
Examples
| Goal | Command | Outputs | Comments |
|---|---|---|---|
| Detect events using a pre-defined set of options optimal for a benthic video, create a mpeg of the results, and apply a video mask |
runclip -m videomask.jpg -f benthic -g -i 20100203T080408Z.avi | mpeg clip of the results, XML formatted metadata output suitable for editing the graphical interface |
For a full list of the runclip options, simply run runclip with no arguments. |
Running Beowulf-enabled pmbarivision
Running pmbarivision with runclip
See the notes above for mbarivision. Setup is the same for pmbarivision.
Examples
| Goal | Command | Outputs | Comments |
|---|---|---|---|
| Detect events using a pre-defined set of options optimal for a benthic video, create a mpeg of the results, and apply a video mask |
runclip -w /mnt/scratch/workers -m videomask.jpg -f benthic -g -i 20100203T080408Z.avi | mpeg clip of the results, XML formatted metadata output suitable for editing the graphical interface |
For a full list of the runclip options, simply run runclip with no arguments. |
